home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 April / Macworld (1999-04).dmg / Shareware World / Info / Diet Sleuth 2.1.2 / Documentation / Documentation next >
Text File  |  1999-01-10  |  20KB  |  408 lines

  1.  
  2. Diet Sleuth   
  3. Version 2.1.2
  4. January 10, 1999
  5.  
  6. Thanks for trying out Diet Sleuth.  Section 17 (Registration) explains how you can register your copy of Diet Sleuth, which is a shareware program. 
  7.  
  8. Please take a moment to visit the Diet Sleuth web page, and make sure that you have the latest version, which can be downloaded for free.
  9.  
  10. The URL is:  http://www.blackcatsystems.com/software/diet.html
  11.  
  12.  
  13. 1. Overview
  14. 2. Food Category
  15. 3. Food Selection List
  16. 4. Daily Totals List
  17. 5. Nutritional Information
  18. 6. Daily Total Nutrition
  19. 7. Searching for a food
  20. 8. Adding a food to your daily totals
  21. 9. Deleting or editing a food from your daily totals
  22. 10. Adding your own foods
  23. 11. Favorite foods
  24. 12. Generating a Report
  25. 13. Printing a Report
  26. 14. Weight Manager
  27. 15. Graphs
  28. 16. Preferences
  29. 17. Registration
  30. 18. Version History
  31.  
  32.  
  33.  
  34. 1. Overview:
  35.  
  36. Diet Sleuth allows you to keep track of what foods you eat each day, and their nutritional value. For each day, you select the foods you have eaten, and the number of servings of each. Diet Sleuth will automatically calculate your caloric intake, fat grams, carbohydrates, fiber, protein, cholesterol, along with sodium, potassium, and calcium.  You can select from over 5000 different foods from 21 categories, including fast food, lunchmeat, junk food, seafood, and baby food.  In addition to the included food groups, you can create and edit your own foods in a separate category. You can also create a category of favorite foods to quickly access commonly used foods. 
  37.  
  38. It may take a few seconds at startup before the program starts to run (perhaps half a minute or so on an non PPC machine). This is normal, several database files are being read.
  39.  
  40.  
  41.  
  42. 2. Food Category:
  43.  
  44. In the extreme upper left hand corner of the window, there is the food category pop-up menu. This menu selects one of the 21 food categories, each of which has dozens or hundreds of individual foods. To select a food category, click on this menu, and hold down the mouse button. A pop-up menu appears. Move the cursor up and down to hilite the category of your choice, and release the mouse button. The new food category will be loaded and displayed (which may take a few seconds, during which time the watch cursor will appear to let you know that Diet Detective is working on your request). 
  45.  
  46.  
  47.  
  48. 3. Food Selection List:
  49.  
  50. This is the listing of all of the foods in a particular category, and is located just under the Food Category pop-up menu.
  51.  
  52. You can click on the up and down arrows in the scroll bar on the left side of the list to move through the list, or click on the gray area in the scroll bar to jump through the list. You can also click on the box and drag it to quickly move through the list.
  53.  
  54. A longer description for the food is displayed just under this food list. This description is not abbreviated, and may be easier to understand.
  55.  
  56.  
  57. 4. Daily Totals List:
  58.  
  59. This list appears just below the Food Selection List. It displays all of the foods that you have eaten on a particular day, sorted by meal. (if you indicated at which meal you ate a particular food) Just above this list, the date of the day that you are looking at is shown. 
  60.  
  61. You can click on the left (Prev) and right (Next) arrows to move back or forwards one day. If you hold down the option key while clicking, you will jump one week instead. If you hold down the command key, you will jump 30 days. This allows you to quickly move through the list, to look at foods you have eaten in the past.
  62.  
  63. The number to the left of the name of the food is the number of servings eaten.
  64.  
  65.  
  66.  
  67. 5. Nutritional Information:
  68.  
  69. This display, in the upper right corner of the window, displays the nutritional information for the food you have selected. All information is displayed on a "per serving" basis, the serving size is shown in the display also.
  70.  
  71. Next to the Protein, Carbohydrates, and Fat information, a percentage is displayed. This is the percentage of calories from each.
  72.  
  73. Finally, there is a small pie chart which graphically shows the contributions of protein, fat, and carbohydrates to the total number of calories. Each pie slice is colored the same as the percentage of calories - red for fat, blue for protein, and green for carbohydrates.
  74.  
  75. If you click on a food from your Daily Totals list, then the nutritional information for that food is displayed. In this case, the total nutritional information is displayed for the amount of food that you ate, not per serving.
  76.  
  77. If you click on a meal from your Daily Totals list, then the total nutritional information for all foods eaten at that meal are displayed.
  78.  
  79.  
  80.  
  81. 6. Daily Total Nutrition:
  82.  
  83. This display, in the lower right corner of the window, displays the total nutritional information for all of the foods eaten on the selected day.
  84.  
  85.  
  86.  
  87. 7. Searching for a particular food:
  88.  
  89. With over 5500 different foods in 21 categories, it can sometimes be difficult to find a particular food.
  90.  
  91. Fortunately, Diet Sleuth has a search feature which allows you to find any foods that match your request.
  92.  
  93. To search for foods, perform the following steps:
  94.  
  95. 1. Select "Find..." from the Edit menu.
  96.  
  97. 2. Type in the text that you are looking for. You may type in more than one word, but if you do so, all the words must appear in the food name in exactly the same order that you typed them. For example, "roast beef" would find "roast beef sandwich", but would not find "beef, roast".
  98.  
  99. 3. Click the OK button. Diet Sleuth will search the descriptions of all of the foods available, and jump to the first one that matches your request.
  100.  
  101. 4. If you would like to search for additional foods that match your search request, select "Find Again" under the Edit menu. Diet Sleuth will search for the next food that matches your request. You may continue to do this to search for additional foods.
  102.  
  103.  
  104.  
  105. 8. Adding a food to your daily totals:
  106.  
  107. 1. Select the food category from the Food pop-up menu in the extreme upper left-hand corner
  108.  
  109. 2. Select the food from the list just below this menu. Use the up and down arrows to scroll through the listing.
  110.  
  111. 3. When you have found the food you want, double click on it.
  112.  
  113. 4. In the new window that appears, enter the number of servings of that food. (the name of the food, along with the serving size and weight, is displayed in this new window for your convenience) You may enter a fractional number of servings, such as 2.5 if you desire.
  114.  
  115.  5. Optionally enter the time you ate the food (such as 12:00), selecting AM or PM, and the meal at which you ate the food. 
  116.  
  117. 6. Click on the OK button.
  118.  
  119.  
  120. The food should now be listed in the Daily Total display in the lower left corner of the Diet Something window.
  121.  
  122.  
  123.  
  124. 9. Deleting or editing a food from your daily totals:
  125.  
  126. 1. Double-click on the food in the Daily Total display in the lower left corner of the Diet Something window. You may also click on the food , and then click on the food again while holding down the option key. 
  127.  
  128. 2. You are then asked whether or not you really want to delete this serving of a food, or edit the entry. Click on the Delete button to remove the food, the Edit button to edit this entry, or the Cancel button to leave it.
  129.  
  130.  
  131.  
  132. 10. Adding your own foods:
  133.  
  134. You can create your own entry for a food that is not in one of the supplied categories. 
  135.  
  136. 1. Select "Customize Foods..." from the Action Menu. This brings up the Custom Foods Editor window.
  137.  
  138. 2. Click the New button at the bottom of the window to jump to the next unused custom food.
  139.  
  140. 3. Enter a description for the food, this is the name of the food, and the text that will appear in the scrolling food list.
  141.  
  142. 4. Enter the nutritional information for the various categories, on a per serving basis. For commercially available foods, this information is displayed on the packaging. Most of these values are in grams, some are in milligrams.  If you leave the Calories field blank, Diet Something will calculate the number of calories for you, based on the protein, carbohydrate, and fat values you entered.
  143.  
  144. 5. Enter the serving size, in grams. 
  145.  
  146. 6. Enter the serving text. This is text that can describe what the serving is, such as "One fruit" or "One muffin", it can be whatever you like, since it is later displayed for your viewing only, and isn't actually used by Diet Sleuth for any calculations.
  147.  
  148. 7. Click on the OK button when you have finished, to save your new custom food. Alternatively, click on Cancel, to ignore your new food.
  149.  
  150. You can also use the Custom Foods Editor to edit a previously created custom food. To do this, perform the following steps:
  151.  
  152. 1. Use the left and right arrow keys to scroll through your custom foods until you find the one that you wish to edit. The number in the center of the two arrows is the custom food number. You may have up to 500 custom foods.
  153.  
  154. 2. Edit whatever entries for that food that you wish.
  155.  
  156. 3. Click on the OK button to save your changes, or the Cancel button to ignore them.
  157.  
  158.  
  159.  
  160. 11. Favorite Foods - Creating a list of commonly eaten foods:
  161.  
  162. You can keep often eaten foods in your favorites list. This allows you to quickly reference commonly used foods, making it easier to find them. To add a food to the list, perform the following steps:
  163.  
  164. 1. Select the food by clicking on it (after selecting the correct food category if necessary).
  165.  
  166. 2. Select "Add to Favorites" from the Action menu.
  167.  
  168. This will add the food to the Favorite Foods group (which is the last food in the food groups popup menu). 
  169.  
  170. If you want to remove a food from the Favorites list, select that food in the Favorites list, and select Remove From Favorites from the Action menu.
  171.  
  172.  
  173.  
  174. 12. Generating a report:
  175.  
  176. To generate a report of all of the foods that you have eaten over the last year, select Report Manager from the Windows menu.
  177.  
  178. A report window is now displayed. There are three scroll bars for navigating through the report:
  179.  
  180. The vertical scroll bar on the right hand side of the Report window allows you to scroll up and down through one page of the report.
  181.  
  182. The horizontal scroll bar on the lower right hand side of the Report window allows you to scroll left and right across one page of the report.
  183.  
  184. The horizontal scroll bar on the lower left hand side of the Report window allows you to select which page of the report is displayed. The page number is shown just to the right of this scroll bar.
  185.  
  186. For each day that you have logged food, the report displays what food has been eaten, how many servings, and the Calories, Protein, Carbohydrates, Total Fat, Saturated fat, Poly-unsaturated fat, and Mono-unsaturated fat, along with the totals for the day. If you have specified the meals at which you ate the foods, then the foods eaten for each day are further broken down into meals, with sub-totals for each meal.
  187.  
  188.  
  189. 13. Printing:
  190.  
  191. To print a report, select Print... from the File menu. If you have recently re-selected a different printer from Chooser, then you should first select Page Setup... from the File menu.
  192.  
  193. You can print either the entire report, only print selected pages.
  194.  
  195.  
  196.  
  197. 14. Weight Manager:
  198.  
  199. The Weight Manager allows you to keep track of your weight, and compute your percent body fat. The day viewed may be changed by using the yellow left/right arrows. (As always, holding down option while clicking on an arrow moves by a week, holding down command moves by a month)
  200.  
  201. You can bring up this window by selecting Weight Manager from the Windows menu.
  202.  
  203. For each day, there are four entries you can make:
  204.  
  205. Activity level - This usually does not change much from day to day, and as a default, your previous day's activity level will be copied over to a new day. You may of course override this and select a different activity level. Your activity level is used when computing your Basal Metabolism.
  206.  
  207. The five activity levels are:
  208. Sedentary, and have crashed dieted during the past two years.
  209. Sedentary.
  210. Moderately Active - exercise three to four times a week.
  211. Very Active - exercise more than four times a week.
  212. Extremely Active - exercise six or seven times a week for more than one hour duration.
  213.  
  214. Weight - This is entered in either pounds or kilograms, as selected in the Preferences.
  215. [note: for the time being, please only use pounds and inches, not metric units]
  216.  
  217. Body Measurements - There are two body measurements, used to compute percent body fat. The location for these two measurements differs for men and women. For men it is the circumference of the wrist and waist. For women, it is the measurement of the hips and abdomen.
  218.  
  219. Six calculations are displayed, they are:
  220.  
  221. Calories Consumed - The total calories of all foods eaten during the day.
  222.  
  223. Basal Metabolism - The estimated calories burned by your body during the day.
  224.  
  225. Caloric Surplus/Deficit - The difference between the previous two numbers. 
  226.  
  227. Weight Gain/Loss - The previous number, converted into the estimated change in body weight.
  228.  
  229. Percent Body Fat - The estimated percent of your weight that is body fat.
  230.  
  231. Body Mass Index - A calculation taking into account your height, weight and body fat. Essentially, it indicates whether you are considered overweight, underweight, or of normal weight.
  232.  
  233.  
  234. 15. Graphs:
  235.  
  236. The graph feature allows you to graph several values: weight, calories, fat, carbohydrates, protein. The buttons under the graph select which value is to be graphed.
  237.  
  238. The three buttons on the lower right side select whether to display a year, three months, or one month of data. Data is displayed previous to the currently selected day, which may be selected using the yellow left/right arrows. (As always, holding down option while clicking on an arrow moves by a week, holding down command moves by a month)
  239.  
  240.  
  241. 16. Preferences:
  242.  
  243. You use the Preferences to select settings for Diet Sleuth, and enter certain personal information.
  244.  
  245. There are three sets of information under preferences: General, Personal, and Language.
  246.  
  247. General:
  248.  
  249. Click on the Background Color... button to select the background color of the main Diet Sleuth window.
  250.  
  251. Date format: Select either American (mm/dd/yyyy) or European (dd.mm.yyyy)
  252.  
  253. Weight Units: Select either English (pounds) or Metric (kilograms). This is the unit that you use to enter your weight if you keep track of your weight.
  254.  
  255.  
  256. Personal:
  257.  
  258. Here you enter your name, birthdate, and height (presently it must be in inches), and select your sex.
  259.  
  260.  
  261. Language:
  262.  
  263. Here you select which language Diet Sleuth should use to display text. At present, food names are not translated, but are always in English. Also, some of the translations may be rather rough. 
  264.  
  265.  
  266.  
  267. Known Bugs:
  268.  
  269. None at this time. Please report any bugs that you may find.
  270.  
  271.  
  272.  
  273. 17. Registration:
  274.  
  275. Diet Sleuth is shareware. The registration fee is just $25. You may evaluate the program for up to 30 days without a license file, after which time you won't be able to enter any new information. Once you register and get the license file, you'll be able to continue entering new data. Don't worry, you won't lose any previously entered information before you register.
  276.  
  277. To make registration easier, you can register Diet Sleuth using the Kagi shareware registration service.  This allows you to pay via credit card. Of course, you can always directly send a check to me. If you live outside the USA, a check needs to be in US funds drawn on a US bank. You may instead wish to consider using Kagi. I can't recommend sending cash, as it may be lost or stolen in the mail.
  278.  
  279. You can register Diet Sleuth with Kagi using either of two methods - using the enclosed Register application, or on the web.
  280.  
  281. To register Diet Sleuth on the web, go to the following URL:
  282. http://order.kagi.com/?SZ
  283.  
  284. You'll need to enter your name, email address, and mailing address, and select the program(s) you want to register (in this case Diet Sleuth). Then click the continue button to enter your credit card information (you can use a secure version of the form).
  285.  
  286. To register Diet Sleuth using the enclosed Register application, follow these steps: Select how many copies of Diet Sleuth you want to register, select the payment method, and follow the instructions.
  287.  
  288. If you wish to pay by credit card, press the Copy... button, and paste the copied text into your email editor.  Email the text to shareware@kagi.com and they will process your order, and let 
  289. me know that you've registered, so that I may send you a License file.  You may also print out the form and send it to Kagi via mail.
  290.  
  291. If you want to pay by cash or check, you'll have to print out the form, and send it, along with your payment, to Kagi. (But if you want to pay by either of those two options, you can just send them directly to me)
  292.  
  293. Please be sure to include your email address when you register! I need this to email your License file!
  294.  
  295. You can always find the latest version of Diet Sleuth at this URL:
  296. http://www.blackcatsystems.com/software/diet.html
  297.  
  298. If you have any questions, comments, suggestions, or bug reports, please email them to me at:
  299.  
  300. diet@blackcatsystems.com
  301.  
  302. Chris Smolinski
  303. 4708 Trail Court
  304. Westminster, MD 21158 USA
  305.  
  306.  
  307.  
  308.  
  309. 18. Version History:
  310.  
  311. 2.1.2   1/10/99
  312. Fixed a bug where selecting Favorite Foods before anything else could cause a crash.
  313.  
  314.  
  315. 2.1.1   12/27/98
  316. Fixed a bug in the Recipe Manager that caused incorrect ingredients to be listed.
  317. Added menu items to select the Food and Weight windows.
  318.  
  319.  
  320. 2.1.0   11/28/98
  321. Added long descriptive food names.
  322. Find now changes the food catagory when it finds a food. 
  323.  
  324.  
  325. 2.0.4   11/8/98
  326. Added pie charts showing contributions of fat, protein, and carbohydrates to total calories.
  327. Enlarged the size of food and meal lists.
  328.  
  329.  
  330. 2.0.3   11/1/98
  331. Option-click can now be used in addition to double clicking to select a food to enter or delete.
  332.  
  333.  
  334. 2.0.2   9/28/98
  335. Bug fix - unit conversion could cause a crash.
  336.  
  337.  
  338. 2.0.1   9/26/98
  339. Prevented windows from being placed under the title bar.
  340. Changed name of preferences file to Diet Sleuth Prefs
  341.  
  342.  
  343. 2.0.0   9/25/98
  344. Added the Weight Manager.
  345. Added the Graphing Report.
  346. Fixed some bugs that caused crashes on 68K machines.
  347.  
  348.  
  349. 1.4.1   8/29/98
  350. Added Cholesterol and Iron to Custom Foods Editor.
  351. Fixed some bugs that would cause Type 1 errors on 68K Machines.
  352. Preferences has some additional items in preparation for the Weight Management features
  353. to be added in an upcoming version.
  354.  
  355.  
  356. 1.4.0   8/22/98
  357. Changed the name to Diet Sleuth.
  358. Added Recipe Editor.
  359. Added support for several foreign languages - French, German, Italian, Portuguese, Spanish.
  360. Added ability to select the background color.
  361. Lots of performance tweaks.
  362.  
  363.  
  364. 1.3.0   8/2/98
  365. Added report generation.
  366. Added unit conversion utility.
  367.  
  368.  
  369. 1.2.2   7/31/98
  370. Added online help. 
  371.  
  372.  
  373. 1.2.1   7/29/98
  374. Fixed a bug where foods with fractional servings (like 1.5) would not be displayed in the list of foods eaten for that day, but the nutritional information would show up in the daily totals display.
  375.  
  376.  
  377. 1.2.0   7/25/98
  378. Fixed a bug where deleting an item from the favorite food list would cause the wrong nutritional information to be displayed.
  379. For each food eaten, you can now also record the time, and at which meal the food was eaten.
  380. When viewing food log, the food is displayed by meal. You can now also click on a meal, and see the total nutritional information for all foods eaten at that meal.
  381.  
  382.  
  383. 1.1.0   7/18/98
  384. Added display of number of servings in daily total list.
  385. Watch cursor is displayed while the food group list is being built.
  386. Automatically update custom foods list when a new food is created.
  387.  
  388.  
  389. 1.0.3   6/24/98
  390. Fixed bug with custom food serving size affecting nutritional values.
  391. Fixed bug with totaling daily total calcium.
  392. Fixed location of food group pop-up menu.
  393.  
  394.  
  395. 1.0.2   6/21/98
  396. Added display of calcium.
  397. Added Favorite Foods list.
  398. Added ability to create and edit custom foods.
  399.  
  400.  
  401. 1.0.1   6/17/98
  402. Fixed bug where clicking on the window background could cause crash
  403.  
  404.  
  405. 1.0.0   6/16/98
  406. Initial Release
  407.  
  408.